home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / tftp156.zip / TOSSFTP.DOC < prev    next >
Text File  |  1997-06-20  |  12KB  |  257 lines
  1.  
  2.  
  3.                              TOSS'in for FTP'in
  4.  
  5.                     Copyright(c) 1997, by Lyn B. Borchert
  6.                      All Rights Reserved Internationally
  7.  
  8.                        [ Release  v1.56  06/21/1997 ]
  9.  
  10.            Please read this entire document before using TOSSFTP.
  11.  
  12.                       Author Contact Info has Changed!
  13.  
  14.  
  15.  
  16. LICENSE AND DISCLAIMER
  17.  
  18. "TOSSFTP" refers to all executables and documentation as distributed in the
  19. compressed file in which this file was contained when released.  For the
  20. purposes of this document, "TOSSFTP" refers to the entire release package.
  21.  
  22.   *   TOSSFTP is copyrighted material by Lyn B. Borchert. It may only be
  23.       used in agreement with the conditions set out in this license
  24.       agreement.
  25.  
  26.   *   TOSSFTP is released under the shareware (try before you buy) concept.
  27.  
  28.       -  You may use TOSSFTP for an evaluation period of 30 days. After
  29.          this period you MUST either register TOSSFTP or stop using it and
  30.          delete any of the files associated with it other than the
  31.          distributed compressed file form.
  32.  
  33.       -  Registration is REQUIRED for commercial usage. (a commercial
  34.          environment is; a business, governmental organization,
  35.          association, school, foundation, or any other form of juridical
  36.          person, or any system where TOSSFTP is directly or indirectly used
  37.          to make profit).
  38.  
  39.       -  Each Registration is valid for only one instance of the program.
  40.          Each additional instance used must be registered separately.
  41.          Hence, Multiple processing systems where TOSSFTP is run under more
  42.          than one process must register each process where TOSSFTP is used.
  43.  
  44.       -  TOSSFTP may be distributed freely provided no money or any other
  45.          compensation is asked or accepted without prior written permission
  46.          from the author.  CD-ROM makers and BBS sysops my distribute
  47.          TOSSFTP along with other shareware programs for the minor fee they
  48.          typically charge.
  49.  
  50.       -  TOSSFTP may not be incorporated into any other products'
  51.          distribution file or disks without prior written approval from the
  52.          author of TOSSFTP.  Except where several other shareware programs
  53.          are being freely provided in exchange for duplicating and shipping
  54.          costs and where it is made known to the recipient that they are
  55.          not purchasing the TOSSFTP product and that registration of
  56.          TOSSFTP is still their obligation.
  57.  
  58.   *   Although care has been taken to write and test a program that does
  59.       what this document states, TOSSFTP is provided as is, without
  60.       warranty or guarantee of any kind, either expressed or implied, as to
  61.       the fitness for a particular purpose or quality or performance of
  62.       this program, except that TOSSFTP will occupy disk space.
  63.  
  64.   *   In no event shall Lyn B. Borchert be liable to you or anyone else for
  65.       any damages or cost, including, but not limited to, any lost profits,
  66.       lost savings or lost income which may have resulted from the use or
  67.       inability to use TOSSFTP.
  68.  
  69.   *   In no way is Lyn B. Borchert obligated to you or anyone else to
  70.       provide future versions of, or support for TOSSFTP.
  71.  
  72.   *   Lyn B. Borchert reserves the right not to release future shareware
  73.       versions of TOSSFTP, but switch to a commercial "buy before you try"
  74.       marketing concept instead.
  75.  
  76.   *   If you are currently using an unregistered version of TOSSFTP, then
  77.       you are asked to make a small advertisement for TOSSFTP, in the inlog
  78.       procedure for your BBS system.
  79.  
  80.   *   The compressed file containing the TOSSFTP package may be
  81.       re-compressed using a different program provided all files are
  82.       included in the new compressed form.
  83.  
  84.   *   Distributors are not given permission to include any additional files
  85.       with the TOSSFTP package.
  86.  
  87.   *   Registered versions of TOSSFTP are non-transferable.  You may not
  88.       sell or give your serial number to someone else.  All serial numbers
  89.       and the rights to use a serial number are kept by Lyn B. Borchert.
  90.  
  91.   *   Disassembling or HEX editing of the Executable file(s) is expressly
  92.       forbidden.  Doing so is a direct violation of this license agreement.
  93.  
  94.   *   Registration does not obligate Lyn B. Borchert to support this
  95.       product.  Registration only grants you the privledge of using this
  96.       version of the TOSSFTP package.
  97.  
  98.    *  Your use of TOSSFTP constitutes your agreement to this license and
  99.       disclaimer and your release of the author from any form of liability
  100.       or litigation.
  101.  
  102.  
  103. REGISTRATION
  104.  
  105. After 30 days of evaluation use, you are required to register the TOSSFTP
  106. package if you intend to continue using it.
  107.  
  108. Single non-commercial instances of use can be Registered for $10.00 each use.
  109. Multiple non-commercial instances of 5 or more can be Registered for $40.00
  110. per each group of 5.
  111.  
  112. Single Commercial instances of use can be Registered for $20.00 each use.
  113. Multiple Commercial instances of 5 or more can be Registered for $80.00
  114. for each group of 5.
  115.  
  116. To register, you must fill out the included registration form and mail it
  117. to the indicated address along with the required funds. (TOSSFTP.REG)
  118.  
  119. All serial numbers will be delivered via U.S. Mail.  In addition, if you
  120. request it on the form, your serial number can also be sent to you via
  121. Internet E-mail or can be placed on hold for your FidoNet Mailer to
  122. retreive from my BBS.
  123.  
  124. Sorry, but at this time, online registration via credit card is not
  125. available.
  126.  
  127. Failure to register will cause the program to delay at start up and again
  128. when it finishes processing.  It will also make some noise during these
  129. delays.  The delays will start 30 days after the program is first run, so
  130. for the evaluation period there should be no annoyances and all features
  131. will work.  Even after the evaluation period all features will work, the
  132. program is not crippled!  It is annoying after 30 days though.
  133.  
  134.  
  135. QUIK DOCs
  136.  
  137. There's not much to it.  Place TOSSFTP.EXE and TOSSFTP.CFG in the same
  138. directory.  Edit the config file to match your system.  Then just before
  139. you are going to start the process to transfer mail to your uplink via FTP,
  140. run TOSSFTP from the sub-directory that it resides in. (I put mine in my
  141. echomail tosser directory)
  142.  
  143.  
  144. WHAT THE HECK DOES IT DO?
  145.  
  146. Well first I should explain how getting your mail via FTP works. (for me
  147. anyway)  Basically, there is an FTP host that packages all my echomail in
  148. the normal FidoNet compressed mail format so I can call in and transfer it
  149. to my host.  I then download it from my host to my computer and toss it
  150. the same as if I had just finished receiving it through the phone lines.
  151.  
  152. I can deliver outgoing mail by uploading it and leaving it at the FTP host.
  153. The problem there is it must be in FIDO(tm) compressed form (*.pkt) for him
  154. to process it. As all of us who run Fido Style Mailers know, netmail is not
  155. in compressed format on our systems.  It sits in our mail directory as
  156. *.msg files.  The FTP host can't do anything with *.msg files.
  157.  
  158. As a result, I would have to send my AREAFIX and File Echo link request
  159. messages via telephone.  So, I wrote TOSS'in for FTP'in to scan my mail
  160. directory looking for these link messages and compressing them into Fido
  161. Style *.PKT files.  That way they could be uploaded with the rest of the
  162. outgoing compressed mail and the FTP host could process them.  Thus
  163. eliminating the need to call long distance to deliver Areafix messages.
  164.  
  165. While I was at it (scanning the mail directory that is), I figured I might
  166. as well copy the outbound compressed mail to a temporary directory also.
  167. After all, there were messages there that are file attachs of the outgoing
  168. mail and once the mail is gone, those messages needed to be deleted and the
  169. compressed files truncated.  All stuff I was doing manually before.
  170.  
  171. TOSSFTP will also pack up any routed netmail messages to be delivered on up
  172. the line as well.  The TOSSFTP.CFG files and history file will give you
  173. specific information on how to specify what gets tossed and what doesn't.
  174.  
  175. So, that's pretty much what TOSSFTP does.  To be more specific and concise...
  176.  
  177. When TOSSFTP is run, it first reads in the config file.
  178.  
  179. Then it reads in each *.msg file in the mail directory.
  180.  
  181. It looks at each message header to see if this message is destine for my
  182. uplink by comparing the destination Net/Node number in the message header
  183. with what I put in the config file.
  184.  
  185. If a match is found, it then checks the TO: field of the message to see if
  186. either the AREAFIX name or FILEFIX name is there.
  187.  
  188. If it is, then TOSSFTP makes a *.PKT out of that entire message and places
  189. it in the OUTBOUND directory and deletes the *.msg.
  190.  
  191. If not, it takes a look at the subject line and checks to see if the path
  192. to my PACKETS directory is in there.
  193.  
  194. If it is, that means this is a file attach message for an outgoing mail
  195. bundle which is named in the subject line.  TOSSFTP then copies the
  196. compressed bundle from the PACKETS directory to the OUTBOUND directory,
  197. then truncates the original and deletes the *.msg.  Just like your mailer
  198. would do if it had just finished delivering this mail via the phone line.
  199.  
  200. [NOTE: TOSSFTP will never toss a File Attach message that is not an
  201. Echomail Bundle.  Host Routing File Attach messages is against the rules.]
  202.  
  203. At this point, I would execute my script file to call my InterNet provider,
  204. log in, upload all the files in the OUTBOUND directory, then (provided the
  205. transfer was a success) it deletes all the files in my OUTBOUND directory
  206. and proceeds to FTP the outgoing mail to my FTP host and retrieve my
  207. incoming mail from the FTP host.  Then I download the incoming files into
  208. my Inbound directory, (again, if the transfer was a success) it deletes the
  209. incoming mail from my Internet provider's drive and logs off the Internet.
  210. Next the batch file runs my mail tosser and finally reloads my mailer.
  211.  
  212. That's about all there is to it.
  213.  
  214.  
  215.  
  216. THE FUTURE.
  217.  
  218. The work I do on TOSSFTP is directly related to my personal needs first and
  219. secondly to the needs of registered users.  The more registered users there
  220. are the more I will feel the desire to work on the program.  There is lots
  221. that can be done to improve and enhance TOSSFTP and I suspect I will
  222. continue to make those changes over time.
  223.  
  224. I'm always open to suggestions for enhancements and improvements.  Several
  225. very good suggestions have come from registered users.  Some were even
  226. things I would have never thought of, so don't be shy with your
  227. suggestions.
  228.  
  229.  
  230. CONTACTING THE AUTHOR
  231.  
  232. (all this information is subject to change over time)
  233.  
  234.      Snail Mail:
  235.                   Lyn Borchert
  236.                   4956 E. 3rd Street
  237.                   Tucson, Arizona 85711
  238.  
  239.    FidoNet Mail:
  240.                   1:300/12@FIDONET
  241.  
  242. InterNet e-Mail:
  243.                   lyn.borchert@usa.net
  244.  
  245.      BBS Number:
  246.                   (520) 326-2999
  247.  
  248.        Web Site:
  249.                   http://www.dakotacom.net/~lynbor
  250.  
  251. My Voice Phone number was intentionally left out.  Please do not call me
  252. voice to talk about TOSSFTP.  I read my mail every day and most of the time
  253. more than once a day.  Mail reading I can do when it is convient to me.
  254. Voice messages from non-registered users will be totally ignored and those
  255. from registered users will be annoying to me, so please don't call me voice.
  256.  
  257.